Security News
The Unpaid Backbone of Open Source: Solo Maintainers Face Increasing Security Demands
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
Generator based control flow that supports both callbacks and promises.
npm install caco
Many existing flow-control libraries such as co, assume promises to be the lowest denominator of async handling. Callback functions require promisify to be compatible, which creates unnecessary complication.
In caco, both callbacks and promises are yieldable. Resulting function can also be used by both callbacks and promises. This enables a powerful control flow while maintaining simplicity.
var caco = require('caco')
var fn = caco(function * (next) {
try {
yield Promise.reject('boom') // yield promise reject throws error
} catch (err) {
console.log(err) // 'boom'
}
var foo = yield Promise.resolve('bar') // yield promise
yield setTimeout(next, 1000) // yield callback using 'next' argument, delay 1 second
// yield callback of form next(err, data): return data, throw if err exists
var data = yield fs.readFile('./foo/bar', next)
return data
})
// Use with callback
fn(function (err, res) { })
// Use with promise
fn().then(...).catch(...)
Yieldable callback works by supplying an additional next
argument. Yielding non-yieldable value pauses the current generator.
Until next(err, val)
being invoked by callback,
where val
passes back to yielded value, or throw
if err
exists.
By default, the following objects are considered yieldable:
Promise
Observable
Generator
Caco also accepts a yield mapper callback function, so that one can yield pretty much anything.
function mapper (val, cb) {
// map array to Promise.all
if (Array.isArray(val)) {
Promise.all(val).then(function (res) {
cb(null, res)
}, cb)
return true // acknowledge yieldable
}
// Anything can be mapped!
if (val === 689) {
cb(new Error('DLLM'))
return true
}
}
caco(function * () {
console.log(yield [
Promise.resolve(1),
Promise.resolve(2),
3
]) // [1, 2, 3]
// yield 689 throws error
try {
yield 689
} catch (err) {
console.log(err.message) // 'DLLM'
}
}, mapper)(function (err, res) {
// handle error or return
})
Multiple results can be aggregated in one yield
by using Promise.all
or callback-all.
var caco = require('caco')
var cball = require('callback-all')
caco(function * (next) {
// Promise.all
var promises = [
asyncFn1() // foo
asyncFn2() // bar
asyncFn3() // hello
asyncFn4() // world
]
console.log(yield Promise.all(promises)) // ['foo', 'bar', 'hello', 'world']
// callback-all
var all = cball()
asyncFn1(all()) // foo
asyncFn2(all()) // bar
asyncFn3(all()) // hello
asyncFn4(all()) // world
console.log(yield all(next)) // ['foo', 'bar', 'hello', 'world']
})(function (err, res) {
// handle error or return
})
MIT
FAQs
Generator based control flow that supports both callbacks and promises
The npm package caco receives a total of 3 weekly downloads. As such, caco popularity was classified as not popular.
We found that caco demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Solo open source maintainers face burnout and security challenges, with 60% unpaid and 60% considering quitting.
Security News
License exceptions modify the terms of open source licenses, impacting how software can be used, modified, and distributed. Developers should be aware of the legal implications of these exceptions.
Security News
A developer is accusing Tencent of violating the GPL by modifying a Python utility and changing its license to BSD, highlighting the importance of copyleft compliance.